Skip to content

task(docs): refresh kongctl documentation for v1.14 - #7039

Merged
Guaris merged 4 commits into
mainfrom
task/kongctl-1-14-docs
Sep 2, 2026
Merged

task(docs): refresh kongctl documentation for v1.14#7039
Guaris merged 4 commits into
mainfrom
task/kongctl-1-14-docs

Conversation

@rspurgeon

@rspurgeon rspurgeon commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Refresh the kongctl conceptual and resource documentation for capabilities through the upcoming v1.14 release.
  • Add complete sync-scope safety guidance, AI Gateway GA resource coverage, audit-log pull and follow workflows, token lifecycle commands, output controls, templates, lookup and secret behavior, and current dump behavior.
  • Add an end-to-end AI Gateway OpenAI quickstart and improve landing-page, command-page, and Konnect discoverability.
  • Correct works_on metadata for Konnect-only commands without editing generated CLI help.

Release gating

This draft targets publication after kongctl v1.14.0.

Keep this PR in draft until the remaining release dependencies are complete.

Validation

  • make validate-frontmatters
  • Vale on every changed Markdown and landing-page file: 0 errors, warnings, or suggestions
  • Vale on extracted Markdown frontmatter: 0 errors, warnings, or suggestions
  • git diff --check

A full local site build could not run on this host. The pinned Ruby 3.4.4 native dependencies google-protobuf and liquid-c fail to compile against the installed C toolchain because the Ruby headers do not provide the expected bool definitions. This is an environment dependency failure; the PR should still receive the normal CI build and link checks.

Closes Kong/kongctl#1998

@netlify

netlify Bot commented Aug 31, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit ec388e1
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a987ab80f45c2000889c785
😎 Deploy Preview https://deploy-preview-7039--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/declarative.md Outdated
Comment thread app/kongctl/supported-resources.md Outdated
@rspurgeon
rspurgeon force-pushed the task/kongctl-1-14-docs branch from 3b250ed to c2488c5 Compare August 31, 2026 17:23
@rspurgeon
rspurgeon marked this pull request as ready for review August 31, 2026 17:32
@rspurgeon
rspurgeon requested a review from a team as a code owner August 31, 2026 17:32
@rspurgeon
rspurgeon force-pushed the task/kongctl-1-14-docs branch 2 times, most recently from 72cf292 to 024ea68 Compare August 31, 2026 21:03
@rspurgeon
rspurgeon marked this pull request as draft August 31, 2026 21:04
@rspurgeon
rspurgeon marked this pull request as ready for review August 31, 2026 21:08
@lena-larionova lena-larionova self-assigned this Aug 31, 2026
@Guaris

Guaris commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Unpublished the how-to in order to get the bulk of the docs out. I created a ticket to revisit the how-to #7100

@Guaris
Guaris force-pushed the task/kongctl-1-14-docs branch from 114ebcb to ec388e1 Compare September 2, 2026 19:36
@Guaris
Guaris merged commit a6d9e79 into main Sep 2, 2026
14 checks passed
@Guaris
Guaris deleted the task/kongctl-1-14-docs branch September 2, 2026 20:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

task(docs): refresh developer site for current kongctl capabilities

3 participants